home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Programming / Complete Applications / Othello C Source / AboutOthello next >
Encoding:
Text File  |  1985-11-25  |  5.0 KB  |  97 lines  |  [TEXT/ttxt]
  1.      Well, here is my long-awaited opportunity to contribute something to
  2. the net.  My only regret is that it is only a game; when my copy of Inside
  3. Macintosh arrives, I will be able to write more useful programs in my spare
  4. time.  However, I have been working on this Othello-playing program off and
  5. on for several months to learn how to write Macintosh programs, and it has
  6. gotten to the point where it is actually presentable, so I thought others
  7. might like to have it.  Notice that, although the "Move" menu is not
  8. dimmed, none of its commands are implemented yet.  I am including both a
  9. binhex 4.0 file and the SUMacC source, including a makefile (that most
  10. important of all parts of any source distribution).  Anyone interested in
  11. grabbing the source code and modifying it might want to get the binhex file
  12. too, since it contains the BNDL, FREF, and ICN# resources necessary to make
  13. the icon appear on the desktop.  I had to do these on the Mac, since the
  14. SUMacC rmaker doesn't know how to create them.  The signature of this
  15. program is "OTLO".  I haven't bothered to register it; I hope it isn't used
  16. yet.  To compile the source, just type "make dl", which will compile
  17. everything and download it to your Macintosh, ready to run.
  18.  
  19.      This article is probably a bit long for a game announcement, but this
  20. program contains the extent of my knowledge about the innards of the
  21. Macintosh, and there were a few points I wanted to mention.
  22.  
  23. User Interface
  24.  
  25.      One of my primary goals in this program was that the user should never
  26. have to wait for the Mac to say it's OK to go on.  At higher skill levels
  27. (like 4 and beyond), the program may take a long time to figure out its
  28. next move, but this doesn't mean that the user has to sit there staring at
  29. the screen waiting for the next move.  While it is "thinking", the user can
  30. still pull down menus, start up desk accessories and use them.  This is
  31. made possible by my approach to handling events, which is slightly
  32. different from that of the other programs I have seen source code for (more
  33. later about the DoEvent() function).  Most importantly, there is a command
  34. that interrupts the program's "thinking" process, so the user can regain
  35. complete control at any time.  Quitting while the program is thinking is
  36. also possible.
  37.  
  38.      Another goal was maximum flexibility.  At any time, even while the
  39. Macintosh is thinking about its next move, all the commands can still be
  40. used.  Changing the skill level or players takes effect on the next move;
  41. other changes (including turning tracing on and off) take effect
  42. immediately.
  43.  
  44. Source Code
  45.  
  46.      When the skel program came out, I stuck my already-existing Othello
  47. program into it so that I could use menus, so you will see some similarity
  48. with that program.  My big departure from it was to replace the
  49. MainEventLoop function with a DoEvent function, which did essentially what
  50. MainEventLoop did, but just once.  Hence, the main program contains
  51.  
  52.         while (TRUE)
  53.                 DoEvent();
  54.  
  55. and I can call DoEvent anywhere I want, to insure that the user never
  56. loses control.  Since the function that determines the next move is
  57. recursive, I only had to put in one extra call to DoEvent.  I also put all
  58. the code dealing with menus in a separate file; it just made more sense to
  59. me to do it that way.
  60.  
  61.      For those of you that learn about the Macintosh by reading source
  62. code, here is a summary of what you can learn from Othello:
  63.  
  64. Fonts, etc.:
  65.         info.c draws strings in different fonts and styles (bold, italic,
  66.         plain text) and centers them.
  67.  
  68. C strings vs. Pascal strings:
  69.         In menu.c, where it handles the "About Othello" command, the
  70.         original version of skel I had used a kludgey way of converting
  71.         the Pascal string returned from GetString() to a C string that
  72.         didn't work in some cases.  You can see how isapstr() solves that
  73.         problem there and in info.c.
  74.  
  75. Graphics:
  76.         drawboard.c draws various lines and ovals.
  77.  
  78. Further Work
  79.  
  80.      To those who decide to look at the source code, I would like to know
  81. why the Extras desk accessory (version 1.2) crashes the system when it
  82. closes from within Othello; it's OK as long as I don't close it.  Other
  83. improvements to be done are implementing the "Save Game" function (I don't
  84. know how to do I/O), implementing the commands in the Move menu (I just
  85. haven't had time -- I have in mind that the undo/redo function will
  86. remember the whole history of the game), and maybe having the program
  87. remember the players, skill, and trace values from one run to the next (by
  88. writing into its data fork?).  Notice that I already have a nice Othello
  89. document icon for saved games, whenever that feature is implemented (I
  90. detest invisible files).  If you make a significant improvement, please let
  91. me know.  Not that I think this is a very important program, but I my be
  92. interested in seeing how it's done.
  93.  
  94.                                         Steven Munson
  95.                                         sbm@purdue.ARPA
  96.                                         sbm@purdue.CSNET
  97.